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PREFACE 


The DX Products Programmer's Reference 
Manual supplies the reader with sufficient infor¬ 
mation to process or produce a word processing- 
formatted file on a Digital Equipment Corporation 
PDP-11 computer running either the RSTS/E or 
RSX-11M operating system. 

The information described in this manual applies 
to version V06C or more recent of the RSTS/E 
system, version 3.1 of the RSX-11M system, and 
version V3.1 or more recent of the word process¬ 
ing systems. 

A knowledge of either the RSTS/E or RSX-11M 
operating system is recommended for understand¬ 
ing the information presented in this reference 
manual. Additional information may be obtained 
from the following documents: 


RSTS/E V06C System User's Guide , DIGITAL 
part number DEC-11-ORSUB-A-D including 
DEC-11-ORSEB-A-DN1, for information ap¬ 
plicable to the RSTS/E operating system. 

Introduction to RSX-11M, DIGITAL part num¬ 
ber AA-2555C-TC. for information applicable 
to the RSX-11M operating system. 


DX/RSTS Products User's Guide , DIGITAL 
part number AA-5476C-TC, for operating in¬ 
structions applicable to the DX Products. 

WPS-8 Word Processing System Reference Manual 
(Version 2.7), DIGITAL part number AA- 
5267B-TB, and WPS-8 Word Processing 
System Reference Manual (Version 3.0) 
Addendum, DIGITAL part number AD-5267B- 
Tl, for both operating instructions and back¬ 
ground material applicable to the PDP-8 word 
processing system (WPS-8). 

WPS-11M Word Processing System Reference 
Manual, DIGITAL part number AA-D727A- 
TC, for both operating instructions and back¬ 
ground material applicable to the PDP-11 word 
processing system (running under the RSX- 
11M operating system). 

Word Processing System Communications 
Options User's Manual, DIGITAL part num¬ 
ber AA-5264C-TK. for operating instructions 
applicable to DIGITAL's word processing sys¬ 
tem communications capabilities. 

All numbers used in this document are specified in 

decimal representation unless otherwise noted. 




CHAPTER 1 
INTRODUCTION 


The DX Products Programmers Reference 
Manual describes characteristics of word proc¬ 
essing files that are stored on a Digital Equipment 
Corporation PD P-11 running the RSTS/E 
(Resource Sharing Timesharing System/ 
Extended) or the RSX-11M (Resource Sharing 
Executive) operating system. This manual speci¬ 
fies the requirements to be met in creating a word 
processing file from a nonword processing input 
medium. 

Figure 1 -1 illustrates the layout of a word process¬ 
ing file as stored in the RSTS/E or RSX-11M file 
structure. The following three word processing file 
characteristics, shown in Figure 1-1, are de¬ 
scribed in this manual. 

CHARACTER 



Figure 1-1 General Organization of Word 
Processing File Stored in the 
RSTS/E and RSX-11M System 


1. Header block, or the first 512 characters 
of each file. A header block contains the 
origination and modification dates of the 
word processing file plus values that con¬ 
trol the appearance of printed output. 
These output-controlling values are de¬ 
rived from the word processing Print Menu 
settings. Chapter 2 describes the interpre¬ 
tation of file header blocks. 

2. Text formatting codes, or particular char¬ 
acters and character combinations that in¬ 
dicate how succeeding text is to be format¬ 
ted (underlined, boldfaced, or page ending, 
for example). The formatting codes them¬ 
selves are not interpreted as part of the 
word processing file’s text. Text formatting 
codes may appear anywhere in the text 
portion of a file (but not in the header). 
Chapter 3 describes the interpretation of 
text formatting codes. 

3. Rulers, or coded information that specifies 
vertical line spacing (half space, single 
space, space and one half, double space), 
the locations of left and right margin posi¬ 
tions, and the locations and types of tab set¬ 
tings (left-aligned, right-aligned, decimal- 
aligned). Rulers may appear anywhere in 
the text portion of a file (but not in the 
header). Chapter 4 describes the interpre¬ 
tation of rulers. 





CHAPTER 2 
FILE HEADER BLOCK 


The first 512 characters of each word processing 
file stored in the RSTS/E or RSX-11M system 
constitutes a header block. Of these 512 characters, 
the first 256 specify when the file was created and 
edited in addition to how it is to be formatted when 
printed (derived from the word processing Print 
Menu settings). The second 256 header block 
characters are available for use by the applications 
programmer. Text of the word processing file fol¬ 
lows the header. Figure 2-1 illustrates the 
layout of a file header block. 

The contents of a file header block are described in 
Table 2-1 by character position. Where applic¬ 
able, the word processing Print Menu two-letter 
abbreviation is given in parentheses. 

CHARACTER 



Figure 2-1 General Organization of 
File Header Block 


The value of each character in a file header block 


is encoded to facilitate accurate transmission from 
the word processing system to the PDP-11. To ob¬ 
tain the correct value, decode each character ac¬ 
cording to the following: 

1. If the value of the file header block character 
is 95. replace the value with 0. 

2. If the value of the file header block character 
is not 95, subtract 31. 

3. If the file header block information occupies 
two characters, multiply the decoded value 
of the first character by 64 and add the de¬ 
coded value of the second character. 

Example: Character positions 11 and 12 (the 
number of blocks in the file) contain 32 and 43, re¬ 
spectively. Decode the values 32 and 43 as follows: 

1. Subtract 31 from 32 to obtain 1. 

2. Subtract 31 from 43 to obtain 12. 

3. Multiply 1 by 64 and add 12 to obtain 76, 
the number of blocks in the file. 

When printed, the values in a file header are inter¬ 
preted as tabulated in the Appendix, Word Proc¬ 
essing Character Interpretation. The values 32 and 
43, given in character positions 15 and 16 in the 
above example, will be printed as a space and a plus 
sign ( + ). 
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Table 2-1 Contents of File Header By Character Position 


Character 


Character 


Position 

Contents 

Position 

Contents 

1-2 

-255 

33-34 

Protection code used only by the 

3-4 

8 


WPS-11M word processing 

5-6 

0 


system. 

7-8 

0 

35-38 

Reserved. 

9-10 

40 

39-40 

1, if the word processing Print 

11-12 

Number of blocks in the file. 


Menu settings have been initial¬ 
ized; 0, otherwise. If 0, system- 

13 

Day file was created 


supplied Print Menu setting values 

14 

Month file was created. 


are supplied when the file is printed. 

15-16 

Year file was created minus 1900. 

41-42 

Number of original copies to be 
printed (CP). System-supplied 

17 

Last day file was edited. 


value = 1. 

18 

Last month file was edited. 

43-44 

Print margin (PM). Number of 

19-20 

Last year file was edited minus 
1900. 


spaces to be added to the left of 
each printed page. System-supplied 
value = 0. 

21-22 

Version number (number of times 
file has been edited). 

45-46 

Number of extra, blank half-lines to 
be used between printed lines 

23-24 

Reserved. 


(EX). System-supplied value = 0. 

25 

Hour when file was last edited. 

47-48 

Top margin (TM). Number of lines 

26 

Minute when file was last edited. 


between the top edge of each page 
and the first text line printed. 

27-28 

Number of lines used per page. 


System-supplied value = 6. 

29-30 

Elapsed time in the most recent 

4V50 

Bottom margin (BM). Number of 


editing session (in minutes). 


lines between the last line of text 

31-32 

Total amount of time spent editing 
(in minutes). 


and the bottom edge of each page. 
System-supplied value = 6. 
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Table 2-1 Contents of File Header By Character Position (Cont) 


Character 

Position Contents 

51-52 Pape size (PS). Number of lines 

that can fit on a page from the top 
edge to the bottom (6 lines = 1 
inch). System-supplied value = 66. 
Page size cannot exceed 200. 

53-54 Pitch (PI). Number of characters 

that can be printed per inch. 

System-supplied value = 10. 

55-56 Number of first page to be printed 

(FR). System-supplied value = 1. 

57-58 Number of last document page to 

be printed (TO). System-supplied 
value = 0, meaning last page of 
document. 

59-60 Number assigned to first page in file 

(IP). System-supplied value = 1. 

61-62. Reserved. 

63-64 1. if pagination is automatic; 0, if 

by user (AP). System-supplied 
value = 1. 

65-68 Reserved. 

69-70 0, to print continuously; 1, to stop 

before printing the first page; 2, to 
stop before printing each page 
(SE). System-supplied value = 0. 

71-72 Reserved. 


Character 

Position Contents 

73-74 1, if output is to be overstruck; 0, 

if output is to be struck just once 
(DA). System-supplied value = 
0 . 

75-76 1, if two printing wheels are to be 

used; 0, if only one wheel is to be 
used (TW). System-supplied value 
= 0 . 

77-78 Output device destination (DD). 

The possible settings are: 

0, for a letter quality printer, 

1, for a draft printer, 

2, for whatever device is attached 
to the host communications 
interface, 

3, for a line printer attached to 
the host system. 

79-80 Column margin (CM). Number of 

spaces to be added between multiple 
columns. System-supplied value = 
0 . 

81-82 Replacement character for extra 

print wheel position 1. 

83-84 Replacement character for extra 

print wheel position 2. 

85-256 Reserved. 
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CHAPTER 3 
TEXT FORMATTING CODES 


Text formatting codes are particular two-character 
combinations that control the appearance of the 
succeeding text For example, a text formatting code 
precedes text that is to be underlined. Formatting 
codes may appear anywhere in the text portion of a 
file (but not in the header). 

A text formatting code begins with either of the two 
characters {(left brace) or I (vertical bar) (print¬ 
able characters are represented in a file by the 
ASCII codes listed in Appendix A). Table 3-1 lists 


the interpretation of all text formatting codes. 


The “enter” codes in Table 3-1 signify modes 
governing the text characters that follow. The 
“leave” codes in T able 3-1 signify the end of a mode 
applicable to the previous text characters. The un¬ 
derline, superscript, and subscript modes are mu¬ 
tually exclusive: if one is in effect, the correspond¬ 
ing “leave” code must be used before another 
“enter” code may occur. 


Table 3-1 Interpretation of Text Formatting Codes 


Code 

Interpretation 

Code 

Interpretation 

(% 

Enter underscore. 

{+ 

Enter subscript. 

(# 

Enter bold face. 

1“ 

Leave bold face. 

r 

Enter “justify." (In this context, jus¬ 

IS 

Leave underscore. 


tify means a sequence of informa¬ 
tion inserted by the word processing 

l& 

Leave justify. 


software and not by the user. 

{( 

Leave superscript. 

o 

Examples include invisible hyphens 
and spaces added as a result of tabs.) 

Enter superscript. 

1* 

Leave subscript. 



NOTE 

The second character of the following codes is rep¬ 
resented in a text file by its corresponding ASCII 
value given in Table A-l less 100 (octal). 


Table 3-1 Interpretation of Text Formatting Codes (Cont) 


Code Interpretation 

I G Word wrap needed. (Succeeding text 

does not properly conform to the 

ruler.) 

I H Begin overstrike sequence. 

! I Tab. 

I J End of line. 

I L End of page. 

I M End overstrike sequence. 


A word processing file stored on the RSTS/E or 
RSX-11M system begins and ends with no modes 
in effect. It ends with the following code sequence: 
set bold face, word wrap needed, clear bold face. 

The appearance of a space or the text formatting 
code for end of line, end of page, or word wrap 


Code Interpretation 

I N Start ruler. 

I O End ruler. 


> 


needed, have special interpretation if certain modes 
are in effect (as a result of the user of an “enter” 
code). Table 3-2 lists the interpretation of the 
character or code when modes are in effect. To ob¬ 
tain the interpretation listed in the third column of 
Table 3-2, the only mode that may be in effect is the 
one listed in the second column. 


Table 3-2 Interpretation of Formatting Characters When Certain Modes Are in Effect 


Character or 

Code in Text Mode in Effect 

Space Justify 


End of line Justify 


Interpretation 

Indicates space was added to make the text conform with mar¬ 
gin settings and tabs. 

Indicates the end of a word processing “word wrapped” line. 
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Table 3-2 Interpretation of Formatting Characters When Certain Modes Are in Effect (Cont) 


Character or 
Code in Text 

Mode in Effect 

Interpretation 

End of line 

Justify/Underline 

Indicates the end of a hyphenated line. 

(Cont) 

Superscript 

Marks a paragraph (as a result of pressing the gold and the 
PARA MARKER keys). 


Subscript 

Ends a centered line. 

End of page 

No specified mode 
has been entered 

Divides the text into pages resulting from a word processing 
NEW PAGE mark. 


Justify 

Divides the text into pages resulting from a word processing 
PAGE MARKER. 


Superscript 

Initiates a word processing header, footer, page number reset, 
multiple column printing request, or comment. 


Subscript 

Terminates a word processing header, footer, page number 
reset, multiple column printing request, or comment. 

Word wrap 
needed 

Boldface 

Indicates that all text between a word wrap needed code and 
the beginning of the next ruler is not in conformance with the 
current ruler. 

Word wrap 
needed 

Any except boldface 

Indicates that all text between a word wrap needed code and 
the next nonjustified line ending is not in conformance with 
the current ruler. 


NOTE 

When the justify mode is in effect, each successive 
printable character is interpreted as a word break 
point, or a point where a hyphen may be inserted to 
end the line. When an overstrike sequence is in 
effect, only printable characters may occur. 
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CHAPTER 4 
RULER CODES 


A word processing ruler is information that indi¬ 
cates the text's vertical line spacing (half space, 
single space, space and one half, double space) 
and the locations of left and right margin positions. 
It may also include the locations and types of tab 
settings (left-justified, right-justified, decimal- 
aligned). An unlimited number of rulers may ap¬ 
pear anywhere in text portion of a file (but not in the 
header). Each ruler has effect until the appearance 
of another ruler or the end of the file. 


As stored in a RSTS/E or RSX-11M word proc¬ 
essing file, a ruler is composed of two parts: (1) in¬ 
formation used to format the previous text, and (2) 
information used to format the succeeding text. The 
two parts may be viewed as a “joined ruler,” separ¬ 
ated by the character. The first part of a joined 
ruler is the same as the last part of the previous ruler 
(to facilitate conforming text to a ruler when scroll¬ 
ing in a backward direction on the word processing 
system). The “joined ruler” begins with a start ruler 
code ( I N) and ends with an end ruler code 



- *- 1 


-$ S -1 


1 N 


@ 


1 0 


-J $- 


-j 5- 




Information used to 
format succeeding » 
text 


End ruler code 


Figure 4-1 General Organization of a Ruler 
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( IO). Figure 4-1 shows an example of a ruler as 
stored in a RSTS/E or RSX-11M word process¬ 
ing file. 

Each ruler may contain several settings. Each set¬ 
ting is indicated by a number and a letter. The 
number specifies the character or column position 


to which the setting applies, while the letter de¬ 
notes the particular setting. The numbers are rep¬ 
resented in hexadecimal form; the letters are rep¬ 
resented in upper case. Table 4-1 lists the 
hexadecimal numbers used in a ruler with their 
equivalent decimal values. Table 4-2 lists the 
codes for all available ruler settings. 


Table 4*1 Hexadecimal Ruler Numbers With Decimal Equivalents 


Hexadecimal 

Decimal 

Hexadecimal 

Decimal 

0 

0 

8 

8 

1 

1 

9 

9 

2 

2 


10 

3 

3 

> 

11 

4 

4 

< 

12 

5 

5 

= 

13 

6 

6 

> 

14 

7 

7 

9 

15 
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Table 4-2 Ruler Setting Codes 


Displays on 

Text Ruler Word Processing 

Code Screen As Meaning 


A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 


> 

T 

L 

R 

D 

J 

W 

P 

C 

N 

H 

F 


Decimal-aligned tab 
Right-justified tab 
Left-justified tab 
Single-spaced left margin 
Ragged right margin 
Double-spaced left margin 
Justified right margin 
Automatic word wrap indent 
Automatic paragraph indent 
Centering point 

Space and one half-spaced left margin 
Hyphenation zone 
Half-spaced left margin 
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The following example illustrates how to interpret a ruler as stored in the RSTS/E or RSX-11M system 


The text that precedes this example rule' was formatted according 
to the INI L5W41R portion as follows. 


IN1|_5W41R@10D41JIO 


v. 


V 


V 


Y 




Start ruler code 


Separator character 


Single spaced left 
margin at character 
position 1 


All text that follows 
the example is 
formatted according 
to the 10D41JI0 
portion as follows: 


Justified right margin 
at character position 
65 (hexadecimal 41) 


Word wrap tab setting 
at character position 5 


Double spaced left End ruler code 

margin at character 
position 16 
(hexadecimal 10) 


Ragged right margin at 
character position 65 
(hexadecimal 41) 


Figure 4-2 Interpretation of Example Ruler 








APPENDIX 
WORD PROCESSING 
CHARACTER INTERPRETATION 


Information in word processing files stored in the 
RSTS/E or RSX-11M file structure is represent¬ 
ed as a series of 7-bit ASCII (American Standard 
Code for Information Interchange) characters in 


the 32 through 95 range. Each character is stored 
right-justified in an 8-bit PDP-11 byte. Table A-l 
gives the octal and decimal equivalent values for all 
permissible word processing characters. 


Table A-l Word Processing Character Set 


Octal 

ASCII 

Decimal 

Octal 

ASCII 

Decimal 

Value 

Character 

Value 

Value 

Character 

Value 

000 

Null 

0 

054 

, (comma) 

44 

040 

Space 

32 

055 

- 

45 

041 

j 

33 

056 

• 

46 

042 

44 

34 

057 

/ 

47 

043 

# 

35 

060 

0 

48 

044 

$ 

36 

061 

1 

49 

045 

% 

37 

062 

2 

50 

046 

& 

38 

063 

3 

51 

047 

’(single quote) 

39 

064 

4 

52 

050 

( 

40 

065 

5 

53 

051 

) 

41 

066 

6 

54 

052 

* 

42 

067 

7 

55 

053 

+ 

43 
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Table A-l Word Processing Character Set (Cont) 


Octal 

ASCII 

Decimal 

Value 

Character 

Value 

070 

8 

56 

071 

9 

57 

072 


58 

073 

y 

59 

074 

< 

60 

075 

= 

61 

076 

> 

62 

077 

? 

63 

100 

@ 

64 

101 

A 

65 

102 

B 

66 

103 

C 

67 

104 

D 

68 

105 

E 

69 

106 

F 

70 

107 

G 

71 

110 

H 

72 

111 

I 

73 

112 

J 

74 

113 

K 

75 

114 

L 

76 

115 

M 

77 

116 

N 

78 

117 

O 

79 

120 

P 

80 


Octal 

Value 

ASCII 

Character 

Decimal 

Value 

121 

Q 

81 

122 

R 

82 

123 

S 

83 

124 

T 

84 

125 

U 

85 

126 

V 

86 

127 

W 

87 

130 

X 

88 

131 

Y 

89 

132 

Z 

90 

133 

[ 

91 

134 

\ 

92 

135 

1 

93 

136 

A 

94 

137 

— 

95 

140 

\ 

96 

141 

a 

97 

142 

b 

98 

143 

c 

99 

144 

d 

100 

145 

e 

101 

146 

f 

102 

147 

q 

103 

150 

h 

104 

151 

i 

105 
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Table A-1 Word Processing 
Character Set 



(Cont) 


Octal 

ASCII 

Decim 

Value 

Character 

Value 

152 

j 

106 

153 

k 

107 

154 

1 

108 

155 

ITT 

109 

156 

n 

110 

157 

o 

111 

160 

P 

112 

161 

q 

113 

162 

r 

114 

163 

s 

115 

164 

t 

116 

165 

u 

117 

166 

V 

118 

167 

w 

119 

170 

X 

120 

171 

y 

121 

172 

z 

122 


The following characters are represented in a text 
file by the equivalent code listed in Table 3-1, 
Interpretation of Text Formatting Codes. While 
these characters may appear on the display screen 
and in printed output, they must be encoded for 
inclusion in a text file. 


Table A-l Word Processing 
Character Set 
(Cont) 


Octal 

ASCII 

Decimal 

Value 

Character 

Value 

173 

i 

1 

123 

174 

1 

124 

175 

) 

125 

176 


126 


The null character is used in word processing files 
stored in the RSTS/E or RSX-11M system as a 
padding character. 
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INDEX 


A 


M 


ASCII characters: in word processing character Margins. See Ruler codes. 

sets. A-1 to A-3 


C 


N 


Character sets. See Word processing files. 


E 


Enter codes. See Text formatting codes. 


F 


File header block. 

Contents, 1-1. 2-2 to 2-3 
Location, 1-1 
Number of characters, 2-1 
Organization, 2-1 
Value of characters, 2-1 
Decoding, 2-1 

Header block. See File header block. 
Hexadecimal numbers, 4-2 


J 


Joined ruler, 4-1 


L 


Leave codes. See Text formatting codes. 
Left brace, 3-1 


Null character, A-3 


P 


Padding character, A-3 


R 


RSTS/E 

Word processing files, 1-1 
File header block, 2-1 to 2-3 
Ruler codes, 4-1 to 4-4 
Text formatting codes, 3-1 to 3-3 

RSX-11M 

Word processing files, 1-1 
File header block, 2-1 to 2-3 
Ruler codes, 4-1 to 4-4 
Text formatting codes, 3-1 to 3-3 
Ruler codes 
Description, 1-1, 4-1 
Displayed on screen, 4-3 
Function. 1-1 
Interpretation. 4-4 
Location. 1-1 
Margins. 4-1, 4-3, 4-4 
Numbers. 4-2 
Organization, 4-1. 4-2 
Setting codes. 4-1, 4-3 
Stored in text, 4-3 
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Tab settings. 4-1. 4-3. 4-4 
Vertical line spacing. 4-1. 4-3. 4-4 


T 


Tab settings. Sec Ruler codes. 
Text formatting codes. 

Description, 1-1. 3-1 
Enter codes. 3-1 
Interpretation. 3-1 to 3-2 
Leave codes. 3-1 
Location. 1-1. 3-1 
Modes. 3-1 

In effect. 3-2 to 3-3 


V 


Vertical bar. 3-1 

Vertical line spacing. See Ruler codes. 


W 


Word processing character interpretation. A-l 
Word processing files. 

Character set. A-l to A-3 
Contents. 1-1 

File header block. 2-1 to 2-3 
Ruler codes. 4-1. to 4-4 
Text formatting codes. 3-1 to 3-3 
Creating. 1-1 

Organization in RSTS E and RSX-11M 
systems. 1-1 
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